home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / bbsutils / ripup100.arj / RIPITUP.DOC < prev    next >
Text File  |  1994-02-13  |  15KB  |  473 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                   RIPit-UP DOOR
  33.                                    Version 1.00
  34.                            Copyright (c) 1994 By Lairware
  35.                            A RIP Icon update utility door
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                                                                          i
  72.  
  73.                                     WARRANTY
  74.                                     --------
  75.  
  76.               RIPit-UP is distributed without warranty.  In no event will Bud
  77.      Younke or  Brian Younke  be liable to  you for  damages, including  any
  78.      loss of profits, lost  savings, or  other incidental or  consequential
  79.      damages arising  out of your use  of or inability to  use the program,
  80.      even if Bud Younke, Brian Younke, or an  authorized representative
  81.      has been advised of  the possibility of  such damages. Bud Younke and
  82.      Brian Younke will not be liable for any such claim by any other party.
  83.      The only guarantee is that this program will take up drive space, and it
  84.      should be less than your BBS software!!
  85.  
  86.  
  87.  
  88.  
  89.      
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.     *****IMPORTANT*****IMPORTANT*****IMPORTANT*****IMPORTANT*****
  128.     The displays for the ansi users will NOT display normally on the
  129.     local screen. The sysop name, bbs name and the prompts(==>) will
  130.     appear to be on the wrong lines, and the top lines of the display
  131.     will be missing. This is caused by scrolling from the user status
  132.     bar. The remote image is alligned correctly. After all it's more
  133.     important it makes sense to them than to you anyhow.<G>
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.                              RUNNING RIPit-UP
  148.                              -------------
  149.  
  150.      RIPit-UP is run as any of our other doors from a batch file which
  151.      includes the line:
  152.      RIPit-UP  door.cfg
  153.      (door)  (config)
  154.  
  155.      In the  above command line, "door" is the name of your door's EXE file
  156.      and the "config"  parameter is  the name of  the door's  configuration
  157.      file(DOOR.CFG).  The configuration file  must reside  in the same
  158.      directory as  RIPit-UP.  The configuration  file is an ASCII text file
  159.      with the following format:
  160.  
  161.      Line 1:   Door data file type.
  162.      Line 2:   Path to the door data file(s).
  163.      Line 3:   BBS name.
  164.      Line 4:   Sysop's name.
  165.      Line 5:   Locked baud rate.
  166.  
  167.      As illustrated above, the door's data file type is specified in line 1
  168.      and can be PCB for  PCBoard, GAP for GAP and WILDCAT! 3.xx (DOOR.SYS,), SF
  169.      for Spitfire, RBBS  for RBBS, WC for WildCat!(Callinfo.bbs), TRIBBS  for
  170.      TriBBS, or WWIV for WWIV. The locked baud rate is specified in line 5. If
  171.      the sysop doesn't lock his serial port, he must specify 0 for the locked
  172.      baud rate. NOTE: Although many door formats do pass the locked baud rate
  173.      in the door data files, some older formats such as RBBS  do not.   For
  174.      conformity, RIPit-UP requires that  you specify the locked baud  rate in
  175.      line 5 and ignores any value passed in the door data files.
  176.  
  177.      The following is a sample door configuration file:
  178.  
  179.      RBBS
  180.      C:\VBBS\
  181.      The Eagle's Lair
  182.      Bud & Brian Younke
  183.      38400
  184.  
  185.  
  186.      Nonstandard IRQs can be  used with RIPit-UP by specifying the IRQ number
  187.      after the  "config" parameter in the command line used to run the door
  188.      as follows:
  189.  
  190.      door config irq
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                               INSTALLING THE FILES
  203.                               --------------------
  204. All files   RIPit-UP.EXE
  205.             DOOR.CFG
  206.             PROTOCOL.DAT
  207. must all be located in the same directory. Do not rename any of the
  208. files. Edit PROTOCOL.DAT and  as needed for your system configuration.
  209. A subdirectory must be created one level below your Main RIPit-UP dir. and
  210. MUST be named "RIPFILES". This is used to store unarchived copies of
  211. your .RIP and .ICN files as well as the temporary filelist for
  212. transfers. You must have a copy of Omen Technologies GSZ or DSZ protocol
  213. in a directory in your DOS path.
  214.  
  215.  
  216.                                  PROTOCOL.DAT
  217.                                  ------------
  218.      A sample PROTOCOL.DAT file is included. It is a simple ASCII text file
  219. which includes the following information:
  220.    Line 1: The name of the protocol you will use (GSZ or DSZ)
  221.    Line 2: The Drive letter for the drive holding the RIPFILES DIR (C D
  222.           No ":" after drive letter
  223.    Line 3: This line determines if you will give the user the option to
  224.           download RIPterm or any other RIP compatible terminal. Enter a
  225.           capital 'Y' if you want them to have this option or a capital
  226.           'N' to disable this option.
  227.    Line 4: This is the complete path and filename to the RIP compatible
  228.           terminal for the user to download.  ***IMPORTANT*** EVEN IF
  229.           LINE 3 IS SET TO 'N' THIS LINE MUST CONTAIN SOME FORM OF ENTRY
  230.           EVEN IF IT IS ONLY ONE LETTER. IF LINE 3 IS SET TO 'N' THIS
  231.           INFORMATION WILL BE IGNORED AT RUNTIME.
  232.  
  233.  
  234.                                  RIP_USER.DAT
  235.                                  ------------
  236.      RIP_USER.DAT is the database file where the username and last date
  237.  of file update is stored. RIPit-UP will create this file on startup if
  238.  it is not found. If a user is not listed in the database RIPit-UP will
  239.  assume they have NONE of your screens and will download all files to
  240.  the user, and then append their record to the end of RIP_USER.DAT. DO
  241.  NOT ATTEMPT TO MANUALLY EDIT THE RIP_USER.DAT FILE!
  242.  
  243.  
  244.  
  245.                                   SPECIAL KEYS
  246.                                   ------------
  247.  
  248.      While RIPit-UP is running,  the sysop can press certain special  keys to
  249.      perform a  variety of  functions.   The  following is  a  list of  the
  250.      functions that the RIPit-UP special keys perform:
  251.  
  252.      Key(s)              Function
  253.  
  254.      HOME                Toggles between the user  status window and a help
  255.                          display that lists the RIPit-UP special keys.
  256.  
  257.      F6                  Takes 5 minutes away from the caller.
  258.                          NOTE:  This will NOT be returned to BBS.
  259.  
  260.      F7                  Gives 5 minutes to the caller.
  261.                          NOTE:  This will NOT be returned to the BBS.
  262.  
  263.      F9                  Quit the door and return the caller to the BBS.
  264.  
  265.      F10                 Enter  chat mode.  Pressing the  ESC key exits the
  266.                          chat mode.
  267.  
  268.      Alt+D               Drop to DOS.
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.                              REGISTRATION
  277.                              ------------
  278.        RIPit-UP is distriuted as a fully functional program. All RIP
  279.        screens are hard coded into the EXE file and are not user
  280.        editable. Registration will allow the SysOp to install a closing
  281.        RIP screen of his choice as a standard .RIP file and  will
  282.        eliminate the 30 second registration nag. We spent some time
  283.        considering a cripple version of RIPit_UP and decided against
  284.        releasing this program as crippled. Considerations were not
  285.        enabling mouse support, limiting the number of users in the
  286.        database or the number of files that could be transferred. We
  287.        decided to count on YOUR honesty to abide by the license
  288.        agreement below if you feel that RIPit-UP is worthwhile.
  289.        Registrations will encourage further development  of RIPit-UP.
  290.  
  291.  
  292.        RIPit-UP is distributed as shareware. You are granted a liscense to
  293.        use RIPit-UP for evaluation purposes only for a period of up to 30
  294.        days. After 30 days you must either register RIPit-UP or
  295.        discontinue use of the program. You are permitted to copy and
  296.        distribute copies of RIPit-UP provided only the original unmodified
  297.        files are distributed.
  298.        The archiver used may be changed to any of your choice. You are
  299.        not permitted to charge for copies of RIPit-UP other than a disk
  300.        copying fee not to exceed $3.00. Access fees for electronic BBS
  301.        systems are exempt provided the access fees are for general
  302.        access to the entire system and not for specific files.
  303.        The registered version of RIPit-UP may not be distributed under ANY
  304.        condition.
  305.        Registration of RIPit-UP is $12.00 US. This includes the latest
  306.        registered copy of RIPit-UP, and a free copy of Lairware's User
  307.        Toast door! Please specify 3.5 or 5.25 Disk size. Orders will be
  308.        shipped U.S. Mail first class as soon as received.
  309.  
  310.        Money orders only... sorry no personal checks....
  311.  
  312.                Look for more Lairware Doors coming soon to a BBS
  313.                      Near You!
  314.        For support......
  315.        And Registration.......
  316.               The Eagle's Lair BBS
  317.               (814)742-9364
  318.               300/1200/2400   24 Hrs
  319.        FIDOnet @1:2622/9     SAC_NET @814:101/2     FAMNET @77:820/5
  320.  
  321.                           -={OR}=-
  322.  
  323.                Bud Younke
  324.                RD 2 Box 53
  325.                Tyrone, PA 16686
  326.  
  327.  
  328.  
  329.                     SUPPORT / DISTRIBUTION SITES
  330.                     ----------------------------
  331.        The latest shareware version of all LAIRWare programs are
  332.        available on these other fine BBS's as FREE downloads.
  333.                                    |
  334.     THE DOS PROMPT                 |     THE WASTELANDS BBS
  335.     (814)943-1798                  |     (502)839-9161
  336.     Altoona, PA                    |     Lawrenceburg, Ky
  337.     John Chidester, SYSOP          |     Jeff Wayne, SYSOP
  338.                                    |
  339.  __________________________________|___________________________________
  340.  
  341.  
  342.  
  343.  
  344.                              OTHER STUFF......
  345.                              -----------------
  346.       Other products mentioned here are copyright or trademarks of
  347.       their respective owners. We would like to take this opportunity to
  348.       plug VBBS ... Thanks Roland for providing such an
  349.       incredibly configurable BBS package.....
  350.  
  351.          RIPit-UP was compied using Borland's Turbo Pascal 6.0 and
  352. RMDoor by Randy Hunt and Mark Goodwin.
  353.  
  354.  
  355.  
  356.  
  357.                               FUTURE   PLANS
  358.                               --------------
  359.        Additional development of RIPit-UP will depend in a large part on
  360.        the response we receive on this BETA release of RIPit-UP. The
  361.        only plans written in stone are to produce the release version of
  362.        the program with the improvements mentioned above. But just a
  363.        couple of possibilities to keep in mind.
  364.        <1> RIPit-UP will exit with Dos errorlevels for various failures
  365.        throughout the program. These errorlevels are not documented in
  366.        the shareware version. If you feel that this would be an
  367.        advantage to test in your .BAT files then let us know.
  368.        <2> Creating an ASCII log of the RIPit-UP door activity including
  369.        errors and successful downloads, including the filenames... date
  370.        and time stamped.
  371.        <3> And in the further future a routine to allow RIPit-UP to
  372.        "auto-register" your new users based on information stored in
  373.        RIPTerms text variable internal database. This would require that
  374.        your users maintain the necessary information in their database.
  375.        Again your input would be greatly appreciated.
  376.  
  377.       With the successful conclusion of the BETA testing phase of
  378.       RIPit-UP most of our efforts in new development will be directed
  379.       toward "Thunder Valley" a fantasy- trivia- user fight on-line door
  380.       game. (Hey what more could you ask for in one door!!) Most of the
  381.       project is in the planning stage but we will be looking for Beta
  382.       test sites. A file "BETATEST.APP" is included with this release if
  383.       you would like to apply as a Beta test site. Criteria for Beta are
  384.       (1) Software used.. if you are the only applicant running "Gumby
  385.       BBS'" then in all liklihood you will be selected.<G> <2> User
  386.       traffic and open hours.. if we have dozens of applicants with the
  387.       same software then these criteria will be used to select the Beta
  388.       sites for that software. We are also looking for several
  389.       Support/Distribution sites. This information is included on the
  390.       BETATEST.APP form. You do not need to be a Beta site to join us as
  391.       a support board.
  392.  
  393.  
  394.  
  395.  
  396.                          WELL OK ONE MORE THING
  397.                          ----------------------
  398.       We are always looking for ideas for new and original software
  399.       for use by BBS system operators. Feel free to send us any ideas
  400.       you may have. From a single sentence to a detailed layout. If we
  401.       develop your idea we will give you the credit, and include an
  402.       advertisement for your BBS in the program. We'd like to say we
  403.       would pay you for the idea, but hey... we're not exactly getting
  404.       rich at this. What else we can do is offer you a free registered
  405.       copy of one of our game or utility doors!!  So get those ideas
  406.       flying! In the event of duplicate ideas the first one we receive
  407.       based on postmark will be considered to be the winner!
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.                          REVISION  HISTORY
  417.                          -----------------
  418.  
  419.       V 1.00 First general release 2/14/94- Mostly cosmetic changes in
  420.       the Ansi users screens. Prettied them up a bit. A couple minor
  421.       changes to speed up text screen writes. Nothing major.
  422.  
  423.       .05Beta -- Added routines to allow user to download RIPterm if
  424.       they are logged in on an ANSI terminal. Additional error codes
  425.       added to support RIPterm downloads. Added GSZ XModem 1-k support
  426.       for ANSI users.
  427.  
  428.       .04Beta -- Corrected exit routine for ANSI callers so they did not
  429.       get the closing RIP screen, added a message so ansi users did
  430.       not think the bbs had locked up.(Thanks to Jeff Wayne for that
  431.       one!!)
  432.  
  433.       .03Beta -- First general beta release. Cleaned up the code to
  434.       enable RIPTerm to download the icon and rip to the subdirectory
  435.       you have enabled for that particular BBS.
  436.  
  437.       .02 Alpha -- Fixed bug with the append new user routines to
  438.       prevent dupes of usernames. Added mouse support for protocol
  439.       selection. Added PROTOCOL.DAT file to make configuration more
  440.       'generic'
  441.  
  442.       .01 Alpha -- first in house alpha test version. Kluged routines to
  443.       download icon and rip files to the directory selected by the user
  444.       for the BBS.
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.